Skip to content

ci: run --check-citations as the fifth wiki-currency leg#42

Merged
Jammy2211 merged 4 commits into
mainfrom
feature/citations-ci
Jul 9, 2026
Merged

ci: run --check-citations as the fifth wiki-currency leg#42
Jammy2211 merged 4 commits into
mainfrom
feature/citations-ci

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Summary

Follow-up to #40 / PR #41: the new --check-citations audit mode now runs on every PR (and release-time workflow_call) as the fifth leg of the wiki-currency workflow, so Project:path citation staleness is graded automatically alongside symbols, idioms, provenance and version drift.

Scripts Changed

  • .github/workflows/wiki-currency.yml — adds the Citation paths (--check-citations) run to the drift report.
  • autoassistant/audit_skill_apis.py_project_tree gains a pip-install fallback for CI (no git checkouts there): citations resolve against site-packages, checking package-internal paths (autofit/…) and skipping repo-level cites (README.md, docs/) instead of false-flagging them; full checkouts still check everything. Summary line now reports the skipped count.
  • skills/al_audit_skill_apis.md §6 — documents the two resolution tiers and the CI leg.

Validation checklist

  • Local full-checkout run: 90 files, 391 citations, 0 skipped, 0 missing
  • Simulated pip-only environment: package-internal path found, repo-level cite skipped, injected missing path → exit 1
  • Workflow YAML parses; script ast.parse clean
  • The wiki-currency PR run on this branch is itself the end-to-end test

🤖 Generated with Claude Code

Jammy2211 and others added 4 commits July 9, 2026 17:31
Wires the citation-path check into the wiki-currency workflow (PR / dispatch /
workflow_call). CI has no git checkouts, so _project_tree gains a pip-install
fallback: resolve against site-packages and check only package-internal paths
(autofit/...), skipping repo-level cites (README.md, docs/) rather than
false-flagging them — full checkouts (local runs) still check everything.
Verified by simulation: package path found, repo-level cite skipped, missing
package path exits 1.

Follow-up to #40 / PR #41.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The first PR run proved the leg works but exposed the version axis: docs pin
main while CI installs the released stack, so post-release moves (ultranest/,
pyswarms/, weak/model/, quantity/) false-failed. CI now shallow-clones the five
libraries (+ sparse autolens_workspace: scripts/ + root catalogues) into
sources/ — the resolver's documented fallback — so citations grade against the
refs the docs pin; the release install remains ground truth for the symbol /
version / idiom checks only. Pip-install resolution stays as last resort.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
'sparse-checkout set scripts' — root-level catalogue files are included
automatically in cone mode; passing llms.txt as a pattern was fatal.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ntity)

The CI citations leg (grading against origin/main clones) caught what local
sibling checkouts — behind main — could not: nest/ultranest/ and mle/pyswarms/
are deleted upstream, and autolens/quantity/ is archived to
autolens_workspace_developer/legacy. searches.md prose already said the two
samplers weren't public; now the dead Source cites and frontmatter paths are
gone too. stack/autolens.md's Quantity API section becomes a Derived-quantities
note pointing at Tracer methods + the workspace guides.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Jammy2211 Jammy2211 merged commit 0fd78a6 into main Jul 9, 2026
1 check passed
@Jammy2211 Jammy2211 deleted the feature/citations-ci branch July 9, 2026 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant